home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 November: Tool Chest / Dev.CD Nov 00 TC Disk 1.toast / Sample Code / Networking / OTEndpointInfo / OTEndpointInfo.c next >
Encoding:
C/C++ Source or Header  |  2000-09-28  |  6.7 KB  |  224 lines  |  [TEXT/CWIE]
  1. /*
  2.     File:        OTEndpointInfo.c
  3.  
  4.     Contains:    Sample to dump out the endpoint info for common OT endpoint types.
  5.  
  6.     Written by: Quinn "The Eskimo!"    
  7.  
  8.     Copyright:    Copyright © 1997-1999 by Apple Computer, Inc., All Rights Reserved.
  9.  
  10.                 You may incorporate this Apple sample source code into your program(s) without
  11.                 restriction. This Apple sample source code has been provided "AS IS" and the
  12.                 responsibility for its operation is yours. You are not permitted to redistribute
  13.                 this Apple sample source code as "Apple sample source code" after having made
  14.                 changes. If you're going to re-distribute the source, we require that you make
  15.                 it clear in the source that the code was descended from Apple sample source
  16.                 code, but that you've made changes.
  17.  
  18.     Change History (most recent first):
  19.                 7/22/1999    Karl Groethe    Updated for Metrowerks Codewarror Pro 2.1
  20.                 
  21.  
  22. */
  23. // The OT debugging macros in <OTDebug.h> require this variable to
  24. // be set.
  25.  
  26. #ifndef qDebug
  27. #define qDebug    1
  28. #endif
  29.  
  30. /////////////////////////////////////////////////////////////////////
  31. // Pick up all the standard OT stuff.
  32.  
  33. #include <OpenTransport.h>
  34.  
  35. /////////////////////////////////////////////////////////////////////
  36. // Pick up device type definitions.
  37.  
  38. #include <OpenTptLinks.h>
  39.  
  40. /////////////////////////////////////////////////////////////////////
  41. // Pick up device type definitions.
  42.  
  43. #include <OpenTptAppleTalk.h>
  44.  
  45. /////////////////////////////////////////////////////////////////////
  46. // Pick up device type definitions.
  47.  
  48. #include <OpenTptInternet.h>
  49.  
  50. /////////////////////////////////////////////////////////////////////
  51. // Pick up the OTDebugBreak and OTAssert macros.
  52.  
  53. #include <OTDebug.h>
  54.  
  55. /////////////////////////////////////////////////////////////////////
  56. // Standard C prototypes.
  57.  
  58. #include <stdio.h>
  59.  
  60. /////////////////////////////////////////////////////////////////////
  61. // OTDebugStr is not defined in any OT header files, but it is
  62. // exported by the libraries, so we define the prototype here.
  63.  
  64. extern pascal void OTDebugStr(const char* str);
  65.  
  66. /////////////////////////////////////////////////////////////////////
  67.  
  68. /*******************************************************************************
  69. ** EndPointInfo
  70. ********************************************************************************/
  71.  
  72. enum {
  73.     kNumberOfServiceTypeNames = 8
  74. };
  75.  
  76. static char *gServiceTypeConstants[kNumberOfServiceTypeNames] = {
  77.     "unknown",
  78.     "T_COTS",
  79.     "T_COTS_ORD",
  80.     "T_CLTS",
  81.     "unknown",
  82.     "T_TRANS",
  83.     "T_TRANS_ORD",
  84.     "T_TRANS_CLTS"
  85. };
  86.  
  87. static char *gServiceTypeDescriptions[kNumberOfServiceTypeNames] = {
  88.     "unknown",
  89.     "Connection-oriented, transactionless",
  90.     "Connection-oriented, transactionless, orderly release",
  91.     "Connectionless, transactionless",
  92.     "unknown",
  93.     "Connection-oriented, transaction",
  94.     "Connection-oriented, transaction, orderly release",
  95.     "Connectionless, transaction"
  96. };
  97.  
  98. static void PrintFlag(char *flagName, UInt32 flagField, UInt32 flagMask)
  99.     // If the flagMask bit in flagField is set, print the flagName
  100.     // string.
  101. {
  102.   printf("    %s = %d\n", flagName, (flagField & flagMask) != 0);
  103. }
  104.  
  105. static void ValueToString(SInt32 value, char *valueString)
  106.     // Convert value to a string and put it in valueString,
  107.     // formatting the two special case values appropriately.
  108. {
  109.     switch (value) {
  110.         case T_INFINITE:
  111.             sprintf(valueString, "T_INFINITE (%ld)", value);
  112.             break;
  113.         case T_INVALID:
  114.             sprintf(valueString, "T_INVALID  (%ld)", value);
  115.             break;
  116.         default:
  117.             sprintf(valueString, "%ld", value);
  118.             break;
  119.     }
  120. }
  121.  
  122. static void OpenEndpointAndPrintInfo(char *config)
  123.     // Open an endpoint with the given configuration, call
  124.     // OTGetEndpointInfo to get the endpoint information,
  125.     // and print that out in a nicely formatted manner.
  126. {
  127.     OSStatus err;
  128.     EndpointRef ep;
  129.     TEndpointInfo epInfo;
  130.     char *serviceTypeConstant;
  131.     char *serviceTypeDescription;
  132.     char valueString[256];
  133.         
  134.     ep = OTOpenEndpoint(OTCreateConfiguration(config), 0, &epInfo, &err);
  135.     if (err == noErr) {
  136.         printf("TEndpointInfo for “%s”\n", config);
  137.         
  138.         ValueToString(epInfo.addr, valueString);
  139.         printf("  addr (max size of address)              = %s\n", valueString);
  140.         
  141.         ValueToString(epInfo.options, valueString);
  142.         printf("  options (max size of options)           = %s\n", valueString);
  143.         
  144.         ValueToString(epInfo.tsdu, valueString);
  145.         printf("  tsdu (max size of data unit)            = %s\n", valueString);
  146.         
  147.         ValueToString(epInfo.etsdu, valueString);
  148.         printf("  etsdu (max size of expedited data unit) = %s\n", valueString);
  149.         
  150.         ValueToString(epInfo.connect, valueString);
  151.         printf("  connect (max size of connect data)      = %s\n", valueString);
  152.         
  153.         ValueToString(epInfo.discon, valueString);
  154.         printf("  discon (max size of disconnect data)    = %s\n", valueString);
  155.         
  156.         if (epInfo.servtype >= 0 && epInfo.servtype < kNumberOfServiceTypeNames) {
  157.             serviceTypeConstant = gServiceTypeConstants[epInfo.servtype];
  158.             serviceTypeDescription = gServiceTypeDescriptions[epInfo.servtype];
  159.         } else {
  160.             serviceTypeConstant = "unknown";
  161.             serviceTypeDescription = "unknown";
  162.         };
  163.         printf("  servtype                                = %s (%ld)\n", serviceTypeConstant, epInfo.servtype);
  164.         printf("    (%s)\n", serviceTypeDescription);
  165.         printf("  flags                                   = $%08x\n", epInfo.flags);
  166.         PrintFlag("T_SENDZERO (can send 0 byte units)        ", epInfo.flags, T_SENDZERO);
  167.         PrintFlag("T_XPG4_1 (supports GetProtAddress)        ", epInfo.flags, T_XPG4_1);
  168.         PrintFlag("CAN_RESOLVE_ADDR (supports ResolveAddress)", epInfo.flags, T_CAN_RESOLVE_ADDR);
  169.         PrintFlag("CAN_SUPPLY_MIB (SNMP)                     ", epInfo.flags, T_CAN_SUPPLY_MIB);
  170.         PrintFlag("T_CAN_SUPPORT_MDATA (support M_DATA mode) ", epInfo.flags, T_CAN_SUPPORT_MDATA);
  171.  
  172.         (void) OTCloseProvider(ep);
  173.     };
  174.     
  175.     if (err != noErr) {
  176.       printf("OpenEndpointAndPrintInfo(%s) = %d\n", config, err);
  177.     };
  178.     printf("\n");
  179. }
  180.  
  181. static void EndpointInfo(void)
  182. {
  183.     OpenEndpointAndPrintInfo(kEnetName);
  184.     
  185.     OpenEndpointAndPrintInfo(kRawIPName);
  186.     OpenEndpointAndPrintInfo(kUDPName);
  187.     OpenEndpointAndPrintInfo(kTCPName);
  188.     
  189.     OpenEndpointAndPrintInfo(kDDPName);
  190.     OpenEndpointAndPrintInfo(kATPName);
  191.     OpenEndpointAndPrintInfo(kPAPName);
  192.     OpenEndpointAndPrintInfo(kADSPName);
  193. }
  194.  
  195. /////////////////////////////////////////////////////////////////////
  196.  
  197. void main(void)
  198. {
  199.     OSStatus err;
  200.     
  201.     printf("OTEndpointInfo\n");
  202.     printf("-- Prints TEndpointInfo for common endpoint configurations.\n");
  203.     printf("-- This is for informational purposes only, don't even think\n");
  204.     printf("-- about hard-coding any of these values!  If you need them you\n");
  205.     printf("-- should fetch them at run time using OTGetEndpointInfo.\n");
  206.     printf("\n");
  207.     
  208.     err = InitOpenTransport();
  209.     
  210.     if (err == noErr) {
  211.     
  212.         EndpointInfo();
  213.         
  214.         CloseOpenTransport();
  215.     }
  216.     
  217.     if (err == noErr) {
  218.         printf("Success.\n");
  219.     } else {
  220.         printf("Failed with error %d.\n", err);
  221.     }
  222.     printf("Done.  Press command-Q to Quit.\n");
  223. }
  224.